home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / rapc101.zip / RAPC.DOC < prev    next >
Text File  |  1991-03-03  |  7KB  |  136 lines
  1. RA Personell Checker 1.01c
  2. Copyright 1990 Motor City Software
  3. Written by John Parlin
  4. All rights reserved
  5.  
  6. Well, I've tried just about everything and have thrown my hands into the air
  7. in dispair.  RemoteAccess does not automatically format a user's phone number
  8. when it is entered.  This is understandable since not everyone uses a USA
  9. style phone number format.  But here in the USA, it's frustrating trying to
  10. get users to enter a phone number using the format that CBV's can understand.
  11.  
  12. In addition, RA 1.00 offers the new Handle and Birthdate fields.  This is
  13. great except if you're upgrading from RA 0.04 to 1.00.  RA will ask a new
  14. user for this additional information, if the Sysop specifies but RA doesn't
  15. ask for this information if the user was in the user file prior to the Sysop
  16. upgrading to 1.00.  RAPC will obtain this information if the Sysop specifies
  17. it.
  18.  
  19. Distribution Files
  20. ============================================================================
  21.  
  22. Following is a list of files included in the distribution archive:
  23.  
  24. RAPC.NEW        List of what's new
  25. RAPC.EXE        The executable program
  26. RAPC.DOC        This documentation
  27. RAPC.CFG        Sample configuration file
  28. VPHONE.TXT      Text file displayed if voice number is in improper format
  29. DPHONE.TXT      Text file displayed if voice number is in improper format
  30. IPHONE.TXT      Text file displayed if number is located in PHONENUM.CTL
  31. HANDLE.TXT      Text file displayed prior to prompting for a handle
  32. BDAY.TXT        Text file displayed prior to prompting for a birthdate
  33. CHANDLE.EXE     Utility program that erases all current user handles
  34.  
  35. ============================================================================
  36.  
  37. Features and Implementation
  38.  
  39.  
  40. If the Sysop specifies, RAPC will check a user's phone numbers for the
  41. format ###-###-####.  If a phone number is not in this format, it will
  42. prompt the user for it and it will automatically format the number much like
  43. QuickBBS did.  If the files VPHONE.TXT or DPHONE.TXT are found, RAPC will
  44. display them to the screen before prompting the user for a valid number.
  45. These are ASCII text files which you can create explaining why the user is
  46. being prompted for phone number input again.  VPHONE.TXT is displayed prior
  47. to prompting for a voice phone number and DPHONE.TXT is displayed prior to
  48. prompting for a data phone number.
  49.  
  50. RAPC will also compare user phone numbers with PHONENUM.CTL.  Be CERTAIN
  51. that your PHONENUM.CTL file is in the correct format.  Some folks assume that
  52. if they have a line containing "999" in their PHONENUM.CTL file, that
  53. 999-#### will not be allowed.  This is not true.  If you wish to disallow
  54. a given prefix, it should be entered in PHONENUM.CTL as "999-".  RAPC looks
  55. for the embedded string and if it finds it, it will re-prompt the user for a
  56. valid phone number.
  57.  
  58. If RAPC determines that a number is not allowed (through comparison of the
  59. PHONENUM.CTL file), the file IPHONE.TXT (intercepted phone number) will
  60. be displayed, if found.  If not found, a short message will be displayed.
  61.  
  62. If you specify, RAPC will check the user's record to see if they have
  63. selected a handle.  If no handle is specified, RAPC will display the text
  64. file HANDLE.TXT (if it exists) and will then prompt the user to select a
  65. handle.  Handles are checked against TRASHCAN.CTL for embedded, unwanted
  66. words.  Handles are also checked against the user file.  The user will not
  67. be allowed to select a handle that someone else is currently using.  RAPC
  68. will also not allow the handle SYSOP to be used.
  69.  
  70. If you specify, RAPC will check the user's record to see if they have
  71. entered their birthdate.  If no birthdate information is specified, RAPC
  72. will display the text file BDAY.TXT (if it exists) and will then prompt the
  73. user to enter their birthdate.  RAPC will automatically format the birthdate
  74. to proper specs and will also check for date validity.
  75.  
  76. To use RAPC, create a type 7 auto-execute menu entry on your top menu.
  77. Make it the first line with a semicolon in the display field.  Use a flag in
  78. the menu entry so that it will only execute for a new user.  Be sure to define
  79. in RACONFIG, new user information, that this flag be turned on for new users.
  80.  
  81. In the optional data field of the type 7, put RAPC.EXE followed by the
  82. flag which you would like to have turned OFF after execution, and any
  83. other command line parameters as listed below.
  84.  
  85.  
  86. Command line examples:
  87.  
  88.         RAPC.EXE A1 /P          Run RAPC checking phone numbers only.
  89.                                 Turn the A1 flag OFF after execution.
  90.  
  91.         RAPC.EXE A1 /P /H       Run RAPC checking phone numbers and Handle
  92.                                 information.  Turn the A1 flag OFF after
  93.                                 execution.
  94.  
  95.         RAPC.EXE A1 /P /H /B    Run RAPC checking phone numbers, Handle and
  96.                                 Birthdate information.  Turn the A1 flag
  97.                                 OFF after execution.
  98.  
  99.         RAPC.EXE A1 /B          Run RAPC checking birthdate information
  100.                                 only.  Turn the A1 flag OFF after
  101.                                 execution.
  102.  
  103. Next, edit the ASCII text file RAPC.CFG.  This file should contain only
  104. two lines.  These lines should be the path to your RA *.CTL files, and the
  105. path to USERSXI.BBS.  For example, if my PHONENUM.CTL and my TRASHCAN.CTL
  106. files are in my \RA directory, and my USERSXI.BBS file was in my
  107. \RA\MSGBASE directory, the RAPC.CFG file would look like this:
  108.  
  109. \RA\
  110. \RA\MSGBASE\
  111.  
  112. This example shows that the *.CTL files are in the \RA\ directory and the
  113. USERSXI.BBS file is in the \RA\MSGBASE\ directory.
  114.  
  115. RAPC needs to find this file.  Only the first two lines are read.  All other
  116. lines are ignored.  The reason I threw this in here is for those few who would like
  117. to use RAPC on a multi-line setup.
  118.  
  119. That's all there is to it.  Just put RAPC.EXE and RAPC.CFG in your RA directory
  120. where EXITINFO.BBS and DORINFO1.DEF are created.
  121.  
  122. NOTE:  This program utilizes RemoteAccess 1.00 data structures.  No
  123.        conversion programs are needed and none should be used.
  124.  
  125.  
  126. CHANDLE.EXE is a separate utility which allows a Sysop to erase all current
  127. user handles from USERSXI.BBS.  THIS PROGRAM SHOULD NOT BE RUN while the
  128. BBS is in operation.  It also must be in the same directory as USERSXI.BBS.
  129.  
  130.  
  131.  
  132. If you find this program useful (meaning, if you use it) great.  Please pass
  133. it around.  There is no charge or fee for the use of this program.
  134.  
  135.  
  136.